Tcl Source Code

Check-in [5a0f4dbe55]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Remove outdated parts of documentation
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk | main
Files: files | file ages | folders
SHA3-256: 5a0f4dbe559ee566892c158dc497f1e4df684c74631934ff8aeb68effac3f91c
User & Date: jan.nijtmans 2024-06-03 20:21:34.044
References
2024-08-29
05:53
Merge [5a0f4dbe559ee566]: Remove outdated parts of documentation. check-in: 9608a2a2b7 user: pooryorick tags: unchained, INCOMPATIBLE_LICENSE
Context
2024-08-29
05:53
Merge [5a0f4dbe559ee566]: Remove outdated parts of documentation. check-in: 9608a2a2b7 user: pooryorick tags: unchained, INCOMPATIBLE_LICENSE
2024-06-04
16:39
TIP 696 #defines and docs check-in: c3971ab24d user: apnadkarni tags: tip-696
15:35
Space before tab is an extremely unlikely to be correct indentation pattern check-in: f6c559b364 user: dkf tags: trunk, main
11:36
Merge 9.0 Closed-Leaf check-in: 8d1785156d user: jan.nijtmans tags: backout-encoding-doc
2024-06-03
20:21
Remove outdated parts of documentation check-in: 5a0f4dbe55 user: jan.nijtmans tags: trunk, main
20:16
Remove outdated parts of documentation check-in: ebc9ff7266 user: jan.nijtmans tags: core-8-branch
11:47
Use (char *)NULL as end sentinel in documentation (as Linux man-pages already do too, e.g. [https://... check-in: 68eea4fd1e user: jan.nijtmans tags: trunk, main
Changes
Unified Diff Ignore Whitespace Patch
Changes to doc/Access.3.
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
file exists and has read, write and execute permissions, respectively.
\fBF_OK\fR just requests a check for the existence of the file.
.AP "struct stat" *statPtr out
The structure that contains the result.
.BE
.SH DESCRIPTION
.PP
As of Tcl 8.4, the object-based APIs \fBTcl_FSAccess\fR and \fBTcl_FSStat\fR
should be used in preference to \fBTcl_Access\fR and \fBTcl_Stat\fR, wherever
possible. Those functions also support Tcl's virtual filesystem layer, which
these do not.
.SS "OBSOLETE FUNCTIONS"
.PP
There are two reasons for calling \fBTcl_Access\fR and \fBTcl_Stat\fR rather
than calling system level functions \fBaccess\fR and \fBstat\fR directly.







|







29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
file exists and has read, write and execute permissions, respectively.
\fBF_OK\fR just requests a check for the existence of the file.
.AP "struct stat" *statPtr out
The structure that contains the result.
.BE
.SH DESCRIPTION
.PP
The object-based APIs \fBTcl_FSAccess\fR and \fBTcl_FSStat\fR
should be used in preference to \fBTcl_Access\fR and \fBTcl_Stat\fR, wherever
possible. Those functions also support Tcl's virtual filesystem layer, which
these do not.
.SS "OBSOLETE FUNCTIONS"
.PP
There are two reasons for calling \fBTcl_Access\fR and \fBTcl_Stat\fR rather
than calling system level functions \fBaccess\fR and \fBstat\fR directly.
Changes to doc/expr.n.
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
tcl::mathfunc::hypot $x $y
.CE
.PP
See the \fBmathfunc\fR(n) documentation for the math functions that are
available by default.
.SS "TYPES, OVERFLOW, AND PRECISION"
.PP
When needed to guarantee exact performance, internal computations involving
integers use the LibTomMath multiple precision integer library.  In Tcl releases
prior to 8.5, integer calculations were performed using one of the C types
\fIlong int\fR or \fITcl_WideInt\fR, causing implicit range truncation
in those calculations where values overflowed the range of those types.
Any code that relied on these implicit truncations should instead call
\fBwide()\fR, which does truncate.
.PP
Internal floating-point computations are
performed using the \fIdouble\fR C type.
When converting a string to floating-point value, exponent overflow is
detected and results in the \fIdouble\fR value of \fBInf\fR or
\fB\-Inf\fR as appropriate.  Floating-point overflow and underflow
are detected to the degree supported by the hardware, which is generally
fairly reliable.







<
<
<
<
<
<
<
<







329
330
331
332
333
334
335








336
337
338
339
340
341
342
tcl::mathfunc::hypot $x $y
.CE
.PP
See the \fBmathfunc\fR(n) documentation for the math functions that are
available by default.
.SS "TYPES, OVERFLOW, AND PRECISION"
.PP








Internal floating-point computations are
performed using the \fIdouble\fR C type.
When converting a string to floating-point value, exponent overflow is
detected and results in the \fIdouble\fR value of \fBInf\fR or
\fB\-Inf\fR as appropriate.  Floating-point overflow and underflow
are detected to the degree supported by the hardware, which is generally
fairly reliable.